Manage orders - Gets a product promotion by id.

Служба:

Partner Center Rest

Версия API:

v1

Получает сведения о продвижении по идентификатору.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}

С использованием необязательных параметров:

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

Параметры URI

Имя	В	Обязательно	Тип	Описание
id	path	True	string	Идентификатор промоушена.
version	path	True	string
country	query		string	Код страны.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Authorization	True	string	Маркер носителя авторизации
ms-correlationid		string	Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создаст новый для каждого запроса.
MS-CV		string	Используется для отслеживания запросов внутри системы. Если MS-CV не предоставлено, сервер создаст новый для каждого запроса.
ms-requestid		string	Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создаст новый для каждого запроса.

Ответы

Имя	Тип	Описание
200 OK	Contracts.V1.Models.ProductPromotion	Запрос выполнен успешно. Текст ответа будет содержать сведения о продвижении. Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request		Отсутствуют или недопустимые входные данные. Текст ответа предоставит сведения об ошибке. Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized		Запрос не прошел проверку подлинности. Сначала клиент должен пройти проверку подлинности с помощью службы API партнеров. Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden		Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов. Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found		Ресурс не найден или недоступен с заданными входными параметрами. Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error		Служба API партнера или одна из зависимостей не выполнила запрос. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Определения

Имя	Описание
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

Имя	Тип	Описание
description	string
endDate	string
id	string
name	string
properties	Contracts.V1.Models.ProductPromotionProperties
requiredProducts	Contracts.V1.Models.ProductPromotionRequiredProduct[]
startDate	string

Contracts.V1.Models.ProductPromotionPricingPolicy

Имя	Тип	Описание
policyType	string
value	string

Contracts.V1.Models.ProductPromotionProperties

Имя	Тип	Описание
isAutoApplicable	boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Имя	Тип	Описание
pricingPolicies	Contracts.V1.Models.ProductPromotionPricingPolicy[]
productId	string
skuId	string
term	Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Имя	Тип	Описание
billingCycle	string
duration	string